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CHAPTER ONE 


THE GRI-909 SOURCE TEXT EDITOR 


The GRI-909 software package includes a comprehensive source text editor which 


provides the user with a convenient method for 


. generating source text on paper tape (the source 


program input to an assembler is on paper tape) 


- correcting and updating source text tapes through 


keyboard control from the teletype 


listing source text tapes on the teletype 
1.1 INTRODUCTION 


Source text editors eliminate most of the problems associated with the use of 
paper tape as an input medium. These problems arise from the limited flexibility 
of teletypewriters and from the inability to re-arrange information on paper tape. 
The GRI-909 EDITOR uses core memory as an extension to the teletype and allows the 
manipulation of source text in distinct and independent one-line units. 

The EDITOR reads lines of text (from paper tape or the ASR keyboard) into a 
buffer in core memory where they are available for examination or manipulation. In 
particular, the EDITOR supports both line and content-oriented commands to delete, 
correct, preserve or add ASCII-coded text on source tapes. The lines entered into 
the buffer may be individually operated upon in order to prepare a correct sequence 


of text lines before they are punched onto paper tape. 
1.2 SYSTEM CONVENTIONS 


The GRI-909 EDITOR is designed as a part of a larger software system comprised 
of the EDITOR and the FUNCTIONAL and BASIC Assembler Programs. These programs all 
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operate on source text and support the same conventions regarding its organization 
as well as error-recovery mechanisms. These conventions apply throughout the system 
to text being input either through the ASR keyboard or by a paper tape reader. 
Source text is organized into variable length segments called lines and blocks. 
Certain special characters are reserved to delimit lines and blocks and others 


permit error recovery within a line. 
1.2.1 SOURCE TEXT LINE 


A source text line contains up to 80 ASCII characters and is terminated by a 
earrtage-return, denoted by }. The } may optionally be followed by a line-feed 
character. The line is the basic unit of source text which is operated upon by 
either the EDITOR or an Assembler. 

When the EDITOR inputs a line through the keyboard the user does not type a 
line-feed after the carriage-return. The EDITOR inserts a line-feed after the 
carrtage-return when punching paper tape so that the tape may be listed off-line. 
The EDITOR and the Assemblers ignore the line-feed when it is encountered on paper 


tape. 
1.2.2 ERROR RECOVERY 


When source text is input to one of the system programs, the special characters 
rubout and back-arrow (+) are used to facilitate error recovery within a line of 
text. | 

When rubout is encountered, all previous characters in the current line will 
be ignored. If the rubout is immediately followed by a carrtage-return then the 
program will not operate on any portion of the line and will proceed to the next 
line as if the current line had not existed. Otherwise, the current line begins 
with the next character after the rubout. 

The back-arrow, <«, causes the input routine to ignore (backspace over) the 
character which immediately precedes it. Two or more consecutive « characters cause 
the input routine to ignore the corresponding number of characters preceding the 
first <. 

Note that the error recovery characters apply only to text contained within 


the current line. 
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1.2.3 SOURCE TEXT BLOCK 


A source text block contains one or more lines followed by a block terminator. 
The number of lines in a block is at the discretion of the user - usually a block 
will consist of a logical sequence of lines such as a separate source program routine 
or a major segment of a routine. In order to facilitate subsequent re-editing of 
a source tape its blocks should be of manageable length, that is, at least short 
enough so as to be wholly contained in the EDITOR's memory buffer (approximately 
4500 characters). 

Lines within a block are implicitly numbered in decimal notation beginning with 
line number 1. Line numbers are not punched onto a source tape. When a listing is 
generated by a GRI-909 Assembler these implicit line numbers are printed to the left 
of source text lines. When the block terminator is encountered the line numbering 
begins again at 1. Note that when a block is read into the EDITOR's buffer the 
lines contained therein have the same implicit numbers as appeared on the assembly 
listing. 

The block terminator, which immediately follows the last line in the block, is 
either the ASCII alt mode character or the ASCII ese character. On a given tele- 
type the block terminator key is located directly above the ctrZ key on the left 
side of the keyboard. 

Blocks of source text are preceded and followed by at least four inches of 


blank tape. This blank tape is ignored by system program input routines. 
1.3 MODES OF OPERATION 


The EDITOR is structured to operate in two distinct modes 


COMMAND Mode 
TEXT Mode 


In order to select an EDITOR function the user enters the COMMAND mode. In 
this mode the user may issue any of a pre-defined set of commands (described in the 
next chapter). The EDITOR interprets the command and takes all actions necessary 
for command execution. Many of the commands cause the EDITOR to enter the TEXT mode. 


In this mode the user may input source text directly into the memory buffer. 
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Depending on the command, text is entered either through the teletype keyboard or 


from a paper tape reader. 
1.3.1 COMMAND MODE 


At the completion of the initialization procedure (see Appendix A), the EDITOR 
outputs an asterisk (*) to the teletype and places itself in COMMAND mode. In this 
mode, pre-defined user commands are communicated through the teletype keyboard. At 
the termination of each command execution, the EDITOR re-enters COMMAND mode and 


causes output of an asterisk to the teletype. 
1.3.2 TEXT MODE 


Certain commands such as appending, inserting, or changing the lines in the 
memory buffer cause the EDITOR to enter the TEXT mode. The EDITOR, when the TEXT 
mode is entered, types a 3-digit line number on the teletype (except when the text 
is appended from paper tape). This line number corresponds to the position of a 
line location pointer within the memory buffer. In the TEXT mode, the user may 
type consecutive lines of source text. At the beginning of each line of source 
text, the EDITOR updates the line location pointer and prints the corresponding 
line number. At any time, the user may exit from the TEXT mode by typing the 
alt mode or ese character (alt/ese) on the teletype keyboard. This causes the 
EDITOR to return to the COMMAND mode. 


1.4 COMMAND STRUCTURE 


EDITOR commands, which are entered from the keyboard, are of the following 


general form 


[COMMAND CHARACTER]. [OPTIONAL COMMAND PARAMETERS ] 2 


Spaces are not allowed in a command and optional command parameters are separated 
by commas or, in the case of the MOVE command, by a colon. 

The command character is selected from the set of valid commands which are 
described in the following chapter. Parameters each denote line numbers or counts 


and may be composed of 
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a. an arbitrarily long string of ASCII characters enclosed 
in single quotes and denoting the line number in which 


the string is contained 
b. a line number (not greater than 999) denoting itself 


c. the special character, pertod (.) which denotes the 
line number corresponding to the current position of the 


line location pointer 


d. the special character, slash (/) which denotes the line 
number corresponding to the last line in the source 


buffer 


e. a number count (not greater than 32,767) denoting itself 


Parameters may also be composed of meaningful combinations of the above separated 
by the arithmetic operators plus (+) or minus (-). 


Examples of valid parameter forms are: 


10 

tAB! 

+2 

/-5 

3,7 

3,7:15 

'HLT' +5, /-2 


1.5 OFF-LINE OPERATIONS 


It is sometimes necessary to list a source tape off-line. Paper tapes prepared 
using the GRI-909 EDITOR may be listed off-line using any ASR Teletypewriter. The 
off-line listing will look exactly the same as if paper tape were listed on-line with 
the EDITOR using the LIST command, except line numbers will not appear before each 
line of printout. 

Source tapes for input to one of the system programs may be prepared off-line. 
The user types source lines on an ASR keyboard according to the conventions outlined 


in section 1.2. The first block on the source tape must be preceded by a few inches 
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of blank tape. 

Note - source tapes may be prepared on any teletype regardless of whether it 
| generates 8-bit or even-parity ASCII code. Although GRI-909 Software recognizes 
only 8-bit ASCII code internally, text input routines logically or in the high- 


order bit before processing. 


CHAPTER TWO 


OPERATING COMMANDS 


Commands to the EDITOR are grouped under two general headings 


Editing Commands 


Paper Tape Commands 


An explanation and examples of the commands in the EDITOR command repertoire 
are given in the following sections. 

When the EDITOR is in COMMAND mode and the user types a command or command 
parameter incorrectly on the keyboard (see 1.4), the EDITOR will respond with an 
error message consisting of a question mark (?) and the command will be ignored. 

Similarly, if the user desires to abort a command before execution of the 
command is initiated (i.e., before the carrtage-return is typed), the user need only 
end the command statement with an invalid character. An exception to this rule 
occurs when the user is typing a source string enclosed in single quotes. The 


alt/ese, in this case, is the only invalid character which will cause an abort. 
2.1 EDITING COMMANDS 


The following commands permit expanding, altering, deleting, and listing text 


in the memory buffer. 


Each section, containing one command, includes a detailed command description 


and, in most cases, an example of command operation. 


2.1.1 APPEND 


Function: ADD INCOMING TEXT FROM ASR KEYBOARD TO CONTENTS OF MEMORY BUFFER 


Command: Aj) 


The EDITOR enters TEXT mode, the line location pointer is moved to the first 
unused position in the memory buffer (line 1 if the buffer is empty), and the 
corresponding line number is output to the teletype. User input from the keyboard 
is appended to the memory buffer until the alt/ese is struck or until the buffer 
becomes full. 

EXAMPLE : Assume the source buffer to be empty prior to entering the following 
command to the teletype. The information printed to the right is comment information 


for example clarification. 


k 

Ad APPEND command enters TEXT mode. 
001 AAAAA} | Line numbers are printed by the 
002 BBBBB3 EDITOR. Source text is entered by 
003 CCCCC) the user. 

004 DDDDD3 

005 EEEEEE<) Baeck-arrow deletes preceding character. 
006 FFFFF) 

007 HHHHHrubout Rubout deletes entire line. 

007 GGGGG) 

008 HHHHH) 

009 IIIII) 

010 JJIJIIJ) 

011 alt/ese * indicates return to COMMAND mode 
k 


The alt/ese places the EDITOR back in COMMAND mode. Upon termination of the 
APPEND command, the line location pointer is set to the beginning of the last line 


in the memory buffer. 


2.1.2 LIST MEMORY BUFFER 


Function: LIST THE CONTENTS OF ENTIRE MEMORY BUFFER 


Command: Lj 


The contents of the entire memory buffer are listed on the teletype. Line 


numbers are inserted at the beginning of each line of listing. Upon termination of 
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the LIST command, the line location pointer is set to the beginning of the last line 


in the memory buffer. 
EXAMPLE: 
26 Lacks 


* 
LQ 
001 
002 
003 
004 
005 
006 
007 
008 
009 


010 
* 


AAAAA 
BBBBB 
CCCCC 
DDDDD 
EEEEE 
FFFFF 
GGGGG 
HHHHH 
IIIIil 
JI III 


Assume the memory buffer to contain the text from the example in 


The EDITOR lists the contents of 
the memory buffer on the teletype- 
writer. 


The line location pointer, denoted by pertod (.), (see Section 1.4) is set to 


the beginning of line number 10. 


Note that the <« and rubout characters corrected the text during input in the 


previous example. 


2.1.3 LIST LINE 


Function: LIST LINE (denoted by m) 


Command: 


Lm) 


The contents of the line denoted by parameter m are listed on the teletype. 


A line number is inserted at the beginning of the line of listing. Upon termination, 


the line location pointer is set to the beginning of the line listed. 


EXAMPLE: 


or 


* 


L593 


005 
* 


* 


EEEEE 


L'EEE"9 
005 EEEEE 


* 


Assume the memory buffer to contain the text from the example in 2.1.2. 


List line 5. 


List the first line in the memory buffer 
which contains the string "EEE". 
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2.1.4 LIST LINES 


Function: LIST LINES (denoted by m through n, inclusive) 


Command: Lm,nj 


The contents of the line denoted by parameter m through the contents of the 
line denoted by parameter n are listed on the teletype. A line number is printed 
at the beginning of each line of listing. Upon termination of the LIST lines 


command, the line location pointer is set to the beginning of the last line listed. 


EXAMPLE : Assume the source buffer again to contain the text from the example 
in 2.162. 
* ; 
E*AA*.."CCC" 3 List the first line in the memory 
001 AAAAA buffer containing the string "AA" 
002 BBBBB through the line containing the 
003 CCCCC string "CCC". 
* 
or 
* List lines 1 through 3. 
L1, 33 
001 AAAAA 
002 BBBBB 
003. CCCCC 
* 


The line location pointer is set to the beginning of the third line of text 


in the memory buffer. 
2.1.5 GET LINE(S) 


Function: GET LINE(S) (denoted by character string) 


Command: G'character string") 


The parameter associated with the GET is always a string of characters enclosed 
in single quotes. All lines in the memory buffer containing this string are listed 
on the teletype. Upon termination, the line location pointer is set to the beginning 


of the last line listed. 


EXAMPLE : Assume the source buffer to be empty prior to entering the following 


commands. 
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* 


Ad Enter 3 lines. 
001 ABB? 

002 BABBB3 

003 BAAB 3 

004 alt/ese 

r 


G'A"') | Get all lines containing "A". 
001 ABB 
002 BABBB 


003 BAAB 
x 


G'BB'9 Get all lines containing "BB". 


001 ABB 
002 BABBB 
* 


G'BBB'} Get all lines containing 'BBB". 
002 BABBB 
x 


After the last GET the line location pointer is set to the beginning of line 2. 


2.1.6 DELETE LINE 


Function: DELETE LINE (denoted by m) 
Command: Dm) 


The contents of the line denoted by parameter m are deleted from the memory 
buffer. All lines in the buffer following this one (if any) are moved up to fill 
the vacated space. Upon termination of the DELETE line command, the line location 
pointer is set to the beginning of the line preceding the one deleted. All lines 


moved up are re-numbered according to their new relative position in the buffer. 
2.1.7 DELETE LINES 


Function: DELETE LINES (denoted by m through n, inclusive) 


Command: Dm,nj 


The contents of the line denoted by parameter m through the contents of the line 
denoted by parameter n are deleted from the memory buffer. All lines in the buffer 
following the last one deleted (if any) are moved up to fill the vacated space. Upon 
termination of the DELETE lines command, the line location pointer is set to the 


beginning of the line preceding the first one deleted. 


EXAMPLE : Assume the contents of the memory buffer to be the ten lines of the 


example in 2.1.2. 


of 

D/-4,93 Delete lines 6 through 9, (/ denotes 
* the last line, number 10) 

Ld List to show buffer contents. 

001 AAAAA 

002 BBBBB 

003 CCCCC 

004 DDDDD 

005 EEEEE 

006 JJJJI 


* 

The original contents of lines 6 through 9 have been deleted from the memory 
buffer. The characters formerly comprising line 10,'JJJJJ', have been moved to line 
6. . 

Note - Since lines moved up are re-numbered, the successive deletion of non- 
sequential lines is facilitated by making the deletions in reverse numeric order 


(i.e., from bottom up). - 
-2.1.8 KILL MEMORY BUFFER 


Function: KILL THE CONTENTS OF THE ENTIRE MEMORY BUFFER 


Command: Kj 


The entire contents of the memory buffer are deleted and the position of the 


line location pointer is set to the beginning of the buffer (line 1). 


EXAMPLE; Assume the source buffer is empty prior to entering the following 


commands. 


* 


Ad Build a four-line memory buffer. 
001 AAAAA) 

002 BBBBB3 

003 CCCCC) 

004 DDDDD3 

005 alt/ese 

k 

K} Kill the buffer contents. 

k 

L) List the entire buffer contents. 
? : 
k 
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The EDITOR replied to the LIST command with a questton mark (?) since the 


memory buffer is empty and cannot be listed to the teletype. 


2.1.9 INSERT LINE(S) 


Function: INSERT LINE(S) BEFORE LINE (denoted by m) 


Command: Im) 


The EDITOR enters the TEXT mode and types out the line number corresponding 
to the parameter m. The user inputs one or more lines (through the keyboard) which 
are inserted into the memory buffer at this point. The insertion causes lines 
following those typed in (if any) to be moved down and renumbered. The command 
terminates and COMMAND mode is entered if alt/ese is struck or if the memory buffer 
becomes full. Upon termination, the line location pointer is set to the beginning 


of the last line inserted. 


EXAMPLE: Assume the memory buffer is empty prior to entering the following 


commands. 


* 


Ad Build a three-line memory buffer. 
001 AAAAA} 

002 BBBBB3 

003 EEEEE3 

004 alt/ese 

* 


L'EE') Insert new lines before the first 
003 CCCCCQ line containing the character 

004 DDDDD3 string "EE", 

005 alt/ese 

* : 

Ld List the buffer as modified. 
001 AAAAA 

002 BBBBB 

003 CCCCC 

004 DDDDD 


005 EEEEE 
* 


The INSERT command given above is equivalent to 13). 
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2.1.10 CHANGE LINE 


Function: CHANGE LINE (denoted by m) 


Command: Cm) 


The contents of the line denoted by m are deleted from the buffer, the EDITOR 
enters the TEXT mode, and the line number corresponding to m is output to the 
teletype. The user inputs one or more lines (through the keyboard) which are 
inserted into the buffer at this point. The command terminates and COMMAND mode is 
entered if alt/ese is struck or if the buffer becomes full. Upon termination, the 
line location pointer is set to the beginning of the last line inserted. 

A CHANGE command is equivalent to a DELETE followed by either an INSERT or an 
APPEND. | 

EXAMPLE: Assume the buffer to contain the text from the example in 2.1.2. 


* 


C63 Change line 6, 
006 11111) 

007 22222) 

008 alt/ese 

rs 

LQ List new contents. 
001 AAAAA 

002 BBBBB 

003 CCCCC 

004 DDDDD 

005 EEEEE 

006 11111 

007 22222 

008 GGGGG 

009 HHHHH 

010 IIIII 

011 JJIIJ 

x 


2.1.11 CHANGE LINES 


Function: CHANGE LINES (denoted by m through n, inclusive) 


Command: Cm,nj 


The contents of the lines denoted by m through n are deleted from the buffer, 


the EDITOR enters the TEXT mode, and the line number corresponding to m is output to 
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the teletype. The user inputs one or more lines which are inserted at this point. 
Command termination is as above (2.1.10). 


EXAMPLE: Assume the buffer to be as at the end of the previous example. 


* 
c/-3,/-13 
008 88) 


009 99) 
010 alt/ese 
* 


C'B',6) 

002 BBB 
003 alt/ese 
k 


LQ List new contents. 
001 AAAAA 

OO2 BBB 

003 22222 

004 88 

005 99 


006 JJJJJ 
k 


2.1.12 MOVE LINE 


Function: MOVE LINE (denoted by m) BY INSERTING BEFORE LINE (denoted by p) 
Command: Mm:pQ 


The contents of the line denoted by parameter m are inserted at a position in 
the memory buffer denoted by parameter p. The line is deleted from its original 
position. 

EXAMPLE : Assume the memory buffer is empty prior to entering the following 


commands. 


* 


A} Build a six-line memory buffer. 
O01 AAAAA} 

002 BBBBBQ 

003 CCCCC) 

004 EEEEE) 

005 FFFFF) 

006 DDDDDJ 

007 alt/ese 

* 


M'DD':49 MOVE the first line containing the 
character string "DD'' to before line 
number 4. 


LQ List the buffer contents. 
001 AAAAA 
002 BBBBB 
003 CCCCC 
004 DDDDD 
005 EEEEE 


006 FFFFF 
* 


2.1.13 MOVE LINES 


Function: MOVE LINES (denoted by m through n, inclusive) BY INSERTING 
BEFORE LINE (denoted by p) 
Command: Mm,n:p) 


The contents of the line denoted by parameter m through the contents of the 
line denoted by parameter n are inserted at a position in the memory buffer denoted 
by parameter p. The lines are deleted from their original positions. 

EXAMPLE: Assume the buffer contents to be as at the end of the previous 
example (2.1.12). 


* ‘ 
M1, .+2:/3 Move 3 lines to before last line, 
x 


Ld List the buffer contents. 
001 DDDDD 
002 EEEEE 
003 AAAAA 
004 BBBBB 
005 CCCCC 


006 FFFFF 
* 


Note that when pertod (.) is encountered in the second parameter, it takes 


on the value denoted by the first parameter. 
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2.2 PAPER TAPE COMMANDS 


All EDITOR commands so far have been concerned with filling and manipulating the 
contents! of a memory buffer using only the teletype keyboard as the input device. 
The following sections explain how the contents of the memory buffer are read from 
or punched onto paper tape. 

In general, the procedure for punching out a source tape depends largely on the 
user's particular requirements. The EDITOR provides the user with commands which 
help to satisfy these requirements. These commands enable the user to copy entire 
tapes or portions of tapes, to punch lines to tape from the memory buffer, to punch 
the entire contents of the memory buffer to tape, to punch blank tape (leader and 
trailer), and to punch a paper tape into distinct and manageable blocks. 

In this last regard, it is often convenient to punch a paper tape into blocks 
or sections. In other words, the user may wish to separate certain portions of a 
paper tape (subroutines, etc.) with a special block mark character which the EDITOR 
provides (the alt/ese character). On input, when either the FUNCTIONAL or BASIC 
Assembler Program encounters the block mark, an internal line location pointer is 
reinitialized and the next sequential line of assembler listing printout will contain 
001 as its line number. This insures consistency between EDITOR and assembler 


listings. 
2.2.1 PUNCH MEMORY BUFFER 


Function: PUNCH MEMORY BUFFER TO PAPER TAPE 


Command: Pj 


The entire contents of the memory buffer are punched onto paper tape through the 
appropriate output device. The contents of the memory buffer are not deleted and 
remain available. The appropriate output device is selected by setting the Switch 
Register on the user console; bit 14 in the UP position indicates output on the 
high-speed punch, the DOWN position indicates teletype output. 

Note - In the paper tape command examples, items enclosed in quotes are manual 


operations performed by the user. 
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EXAMPLE: Assume the source buffer to contain the text from the example in 
2.1.2. Assume also that bit 14 of the Switch Register is set in the DOWN position 
(indicating teletype output) and that the teletype punch is in the OFF condition. 

k 


P) "set low speed punch in ON condition") 

AAAAA 

BBBBB 

CCCCC 

DDDDD 

EEEEE 

FFFFF 

GGGGG 

HHHHH 

IITIIil 

JJIJIJ "set low speed punch in OFF condition" 

* 

The entire contents of the memory buffer are listed on the teletype as they are 
output to the low speed punch. This is a function of the ASR device. The carrtage- 
return (or any character on the teletype keyboard) must be struck immediately after 
the low speed punch is set in the ON condition and once again after the low speed 
punch is set OFF. This safety procedure insures that the punch is off while the 
user is typing commands on the teletype keyboard (if the low speed punch were set ON, 
the commands as well as the input text would be punched on paper tape). 

EXAMPLE : Assume the memory buffer contains the text inserted in section 2.1.2. 
Assume output is to the high-speed punch (bit 14 of the Switch Register is set in the 
UP position). 


* 


P3 
x 


When the high-speed punch is the output device, the contents of the memory 


buffer are not listed on the teletype and the safety procedure described above does 


not apply. 
2.2.2 PUNCH LINE 


Function: PUNCH LINE (denoted by m) 


Command: Pm 
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The contents of the line denoted by the parameter m are punched onto paper tape 
through the appropriate output device. The contents of the line are not deleted from 
the memory buffer and remain available to the user. The appropriate output device is 


selected as in the PUNCH buffer command in 2.2.1. 
2.2.3 PUNCH LINES 


Function: PUNCH LINES (denoted by m through n, inclusive) 


Command: Pm,n) 


The contents of the line denoted by the parameter m through the contents of the 
line denoted by the parameter n are punched onto paper tape through the appropriate 
output device. The contents of the lines are not deleted from the memory buffer and 
remain available to the user. The appropriate output device is selected as in the 


PUNCH buffer command in 2.2.1. 
2.2.4 BLOCK 


Function: PUNCH BLOCK MARK 


Command: B) 


A block mark alt/ese plus four inches of blank tape is punched onto paper tape 
through the selected output device. This mark defines the end of a block of text on 
tape. The output device is selected as in the PUNCH commands. 

EXAMPLE : Assume bit 14 is in the UP position (high-speed punch) and that the 


buffer is not empty. 


# 

P). Punch the buffer on the high-speed punch. 
#e 

B3 Punch the block mark and blank tape. 

+ 


2.2.5 PUNCH BLANK TAPE 


Function: PUNCH BLANK TAPE (length, in inches, is denoted by q) 
Command: Tq 
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q inches of blank paper tape are punched through the selected output device. 
The default value of q is 10 (i.e., when q is unspecified, 10 inches of blank tape 
are punched). The output device is selected as in the PUNCH commands. 

EXAMPLE : Assume bit 14 of the Switch Register is in the DOWN soa7 een (low- 


speed teletype output). 


k 
T5) "set low-speed punch in ON condition") 


"set low-speed punch in OFF position when tape is punched") 
x 


Once again the 3 (or any character on the keyboard) must be struck immediately 
after the low-speed punch is set in the ON condition and also after the low-speed 


punch is set OFF (in order to avoid punching commands along with text). 
2.2.6 READ BLOCK FROM PAPER TAPE 


Function: READ BLOCK FROM PAPER TAPE 


Command: Rj 


A block of text is read from the appropriate input device. Text is read and 
appended to the memory buffer until a block mark is encountered, the memory buffer 
becomes full, or the end of tape is reached. The input device is selected by setting 
the Switch Register on the user console prior to the READ commands; bit 15 in the UP 
position indicates high-speed reader input, the DOWN position indicates low-speed 
teletype input. 

Upon termination of the READ BLOCK command, the line location pointer is set to 
the beginning of the last line of text in the memory buffer. 

EXAMPLE : Assume the memory buffer contains the text from the example in 
2.1.2. Assume also that the paper tape in the input device contains three lines of 
text, followed by a block mark, followed by three more lines of text. Bit 15 of the 
Switch Register is in the DOWN position indicating low-speed input. 


* "set the teletype reader in start position" 


Rd Read one block from tape. 
x 
L.9 | List the last line read. 


013 PAPER TAPE 
* 
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LQ List the entire buffer. 


O01 AAAAA 

002 BBBBB 

003 CCCCC 

004 DDDDD 

005 EEEEE 

006 FFFFF 

007 GGGGG 

008 HHHHH 

009 IIII1 

010 JJJJJ 

O11 THESE THREE LINES WERE CONTAINED IN ONE BLOCK 
012 AND WERE READ FROM 


013 PAPER TAPE 
* 


Note that only the three lines of text preceding the block mark character were 
read from paper tape. A second READ command would now read in and append the second 


block to the memory buffer. 
2.2.7 READ LINES FROM PAPER TAPE 


Function: READ LINES (the number of lines is denoted by q) FROM PAPER TAPE 
Command: Rq@ 


q lines of text are read from paper tape through the selected input device. 
Text is read and appended to the memory buffer until q lines are read, a block mark 
is encountered, the memory buffer becomes full, or end of tape is reached. The 
input device is selected as in the READ block command. Upon termination of the READ 
lines command, the line location pointer is set to the beginning of the last line 


read in the memory buffer. 


2.2.8 SKIP BLOCK 


Function: SKIP A BLOCK ON PAPER TAPE 


Command: Sj 


The paper tape is advanced through the input device until a block mark is 
encountered (i.e., a block is skipped) or end of tape is reached. No text is added 


to the memory buffer. The input device is selected as in the READ block command. 
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2.2.9 SKIP LINES 


Function: SKIP LINES ON PAPER TAPE 
Command: Sq 
The paper tape is advanced through the input device until q lines are skipped, 


a block mark is encountered, or end of tape is reached. No text is added to the 


memory buffer. The input device is selected as in the READ block command. 


2.2.10 COPY PAPER TAPE 


Function: COPY PAPER TAPE 


Command: N) 


The sequence READ, PUNCH, BLOCK, and KILL is performed until the input tape 
is entirely copied to the output tape. If the memory buffer is not empty when this 
command is entered, the first block on the output tape will be the contents of the 


memory buffer. Upon termination of this command, the memory buffer is left empty. 
2.2.11 COPY BLOCKS FROM PAPER TAPE 


Function: COPY BLOCKS (the number of blocks are denoted by q) FROM PAPER TAPE 
Command: Nq@d 


The sequence READ, PUNCH, BLOCK, and KILL is performed until either q blocks 
have been copied from the input device to the output device or until the end of tape 
is reached. 

EXAMPLE : Suppose a user desires to skip over the first two blocks on an 
input tape, copy the third block, skip over the fourth block, and then copy the 
remaining input tape. The following sequence will accomplish this. Assume the input 
device is low-speed teletype and the output device is high-speed punch. 


* "set the reader in start position" 
S3 Skip first block. 
x 


S) Skip second block. 
* 


N13 | Copy third block. 
* 


Skip fourth block. 


Copy remaining input tape. 
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CHAPTER THREE 
USAGE NOTES 


This chapter presents further operating features of the EDITOR and 


constraints imposed upon text input. 
3.1 CHARACTER SET 


GRI-909 systems programs operate on full 8-bit ASCII characters when 
processing text. The text input routines logically OR in the high order bit 
when reading characters - the characters read may, therefore, be in 8-bit, 7- 
bit, even parity or odd parity code. The ASCII codes, in octal notation, for 


valid text characters are: 


Alphabetics 7 301 through 332 
Numerics 260 through 271 
Other 240 through 257, 


272 through 300, and 
333 through 336 


A complete tabulation of teletype codes and the corresponding 
characters is contained in Appendix F, ''GRI-909 System Reference Manual". 
Other character codes that are recognized, rather than being ignored, by the 


EDITOR are: 


215 (carrtage-return) - Terminates a source text 


line (see section 1.2.1). 


212 (line-feed) - ignored when encountered after 
a carrtage-return. Generated on output after 


a 215 is either printed or punched. 


211 (hortz. tab) - Allowed as text character. 
Echoed on the teleprinter as ">" but punched 


as 211 followed by a null (000) frame. 


337 (back-arrow) - Used for error recovery within 


a source text line (1.2.2). 


e=7 


377 (rubout) - Also used for error recovery within 


a source text line (1.2.2). 


375 (alt-mode) - Terminates a source text block 
(1.2.3). Also causes EDITOR to pass from 
TEXT mode to COMMAND mode (1.3.2). 


233 (ese) - Treated identically to the 375 code. 


3.2 ERROR MESSAGES 
3.2.1 COMMAND ERRORS 


If the EDITOR is in the COMMAND mode and the user types a command or 
a command parameter (1.4) incorrectly, the EDITOR responds with a question 


mark (?) and ignores the command. The various errors detected are: 


the command character itself is invalid, 

b. a list, punch or edit command has been issued and the 
buffer is empty, 

Cc. a parameter contains an invalid character (such as a 
letter in a numeric form), 

d. a line parameter does not address a line in the buffer - 
the value of the parameter is negative or is larger than 
the number of the last line in the buffer, 

e. in the form m,n (denoting line m through n) the value of 
n is less than the value of m, or 

f. in the form m,n:p the value of p does not lie outside 


the group m,n. 
3.2.2 LINE TRUNCATION 


A source text line may contain up to 80 characters followed by a 
carrtage-return (1.2.1). A longer line read from paper tape is truncated 
to 80 characters plus a carrtage-return and "'TR'' is printed by the EDITOR 
upon return to the COMMAND mode. The "TR" indicates that at least one line 


read was so truncated. If an attempt is made to enter a line longer than 
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80 characters from the keyboard, a carrtage-return is issued and the EDITOR 


proceeds as if it had been typed. 


3.2.3 FULL BUFFER 


When in the TEXT mode and before an input line is accepted (from paper 
tape or via the keyboard) the currently available buffer space is checked to 
see if a maximum length line could be contained therein. If not, the EDITOR 
prints the message ''FULL" and returns to the COMMAND mode. Note that this 
check applies also to any editing command that might increase the number of 


characters currently in the buffer. 


3.3 SEARCH STRINGS 


Any parameter m, n or p in the forms 


m 
m,n 
mip 


or m,n:p 


may consist of a series of operands separated by operators, + or - (1.4). Such 
an expression has the conventional algebraic meaning. An operand may be a 
search string - a sequence of characters enclosed in single quotes ('). The 
value of a search string is determined via a search performed by the EDITOR - 

it is the number (in the buffer) of the first line encountered during the search 


that contains the given sequence of characters. 


If a search string operand is encountered when evaluating the parameter 
m or the parameter p, the EDITOR search is begun at the first line in the memory 
buffer. During evaluation of n, this search is begun at the next line after 
the one addressed by the value of m. In either case, the search is begun 
immediately after the rightmost quote of the operand is typed. If the given 
character sequence is located, the EDITOR rings the teletype bell indicating 
that further parameter input may continue. If the search was unsuccessful, the 
EDITOR responds with a question mark and returns to the COMMAND mode - the 


partial command is ignored. 


Since the line terminator (carriage-return) is stored at the end of each 
line in the buffer, it is possible to include it as the last character of a 
search string and thereby address a line that ends with a given sequence of 
characters. Since the EDITOR echoes a carrtage-return with itself and a line- 
feed, the rightmost quote of the operand will appear on the next line of 
printout. Also, for purely typographical reasons, the character pound stgn (#) 
is interpreted as a carrtage-return when a search string of this nature is 


entered. 


NOTE: Since the characters quote (') and pound stgn (#) have special meaning 
| regarding the definition of character strings, neither of them may be 


searched for in text. 


III. 


IV. 


APPENDIX A 


OPERATING INSTRUCTIONS 


Load the text editor with the Absolute Loader. 


Transmit "0'"' to SC, or, if restarting, transmit "2'' to SC to preserve the 


contents of the buffer. 
Set console switches as follows: 


Bit 15 selects text input device 
Bit 14 selects text output device 


UP = High-speed 
DOWN = Low-speed 
Press START 


The text editor will respond with an asterisk (*) indicating that it is in 


the command mode, awaiting a command. 


NOTE: A command such as Get, Punch or List which causes multiple lines 
to be output during execution may be aborted before completion 
by setting bit 0 of the console switches DOWN -- the EDITOR 
returns to the COMMAND mode after the next line is printed or 
punched. This switch should be reset to UP at once in order 


not to interfere with the execution of other commands. 


Bl 
APPENDIX B 
COMMAND SUMMARY 
1/0 


COMMAND”? FUNCTION DEVICE? =~ REFERENCE 
A Append text to buffer K Zoek: 
B Punch block mark P 2.2.4 
Cm | Change line m K 2.1.10 
Cm,n Change lines m through n K Dade 
-Dm Delete line m - Zeke 
Dm,n Delete lines m through n - Zekel 
G'ec...c' Get (and list) all lines containing the string 

C5. 5c T Ze 
Im Insert line(s) before line m K 2.1.9 

Kill (delete) buffer contents - 2.1.8 
L List entire buffer contents © T Zola 
Lm List line m T 2163 
Lm,n List lines m through n T 2.1.4 
Mm: p Move line m by inserting before line p - 2A h2 
Mm,n:p Move lines m through n by inserting before line p - Zi lonk3 
N Perform sequence R,P,B,K until input tape exhausted R,P 262210 
Nq Perform sequence R,P,B,K q times '  R,P pire ape ba | 
P Punch entire buffer contents P 22k 
Pm Punch line m P Lewue 
Pm,n Punch lines m through n P 25243 
R Read block R 22:6 
Rq Read q lines R pa ae | 
S | Skip block R 2.2.8 
Sq Skip q lines R Zien 
T Punch 10" of blank tape P 2.2.5. 
Tq Punch q" of blank tape P IY ae 
NOTES : 


1. Commands are terminated by a carriage-return, }. 


2. Parameters m,n,p represent line numbers, q represents a count-- 
see section 1.4. 


3. The device concerned with text input, output (or scan in S 
commands) is identified as follows: 
K - Keyboard 
P — Selected punch 
R - Selected reader 
T - Teleprinter 


Bits 14 and 15 of the console switch register select the punch and reader 
respectively: UP selects high speed, DOWN selects teletype. 
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